

   WELCOME
----------

Welcome to the Windows distribution of Clean 1.3.3 which includes the 0.8.2
version of the Clean I/O library.

This release runs on Windows 95, 98, 2000 and Windows NT 4.0. (Windows 3.1 will
not be supported, not even with Win32s).

This zip file contains

-  The Clean compiler  (cocl.exe and cg.exe), which is called from
-  The Clean Integrated Development Environment (CleanIDE.exe) with
   a linker (StaticLinker.exe), preferences files (IDEPrefs,IDEEnvs,
   windows.km) and the folder 'bitmaps'.
-  The Clean IDE from Clean 1.3.2 (CleanIDE 1.3.2.exe) with
   its help file ('Clean Help').
-  The standard library for arthmetic, string and list manipulation,
   file I/O, etc. (StdEnv)
-  The I/O library for graphical user interface applications
   (IOInterface 0.8.2). Note that there are some small differences between the 
   Windows version and the Macintosh version of the I/O library. 
   See below.
-  The profile applications 'ShowTimeProfile.exe' and 'ShowHeapProfile.exe'
-  Registry utilities
-  Several example programs, including examples of graphical user
   interfaces (Small Examples & IOExamples).
 
   CHANGES FROM VERSION 1.3.2 TO 1.3.3
--------------------------------------

-  A new IDE (CleanIDE), see 'CleanIDE manual.pdf'.
   The IDE from Clean 1.3.2 can still be used (CleanIDE 1.3.2).
-  The memory profiler (ShowHeapProfile) has been ported to Windows.
-  The time profiler (ShowTimeProfile) can now also show the profile
   information by module, instead of only by function.
-  Both profilers now show the modules in which functions are defined.
-  Some changes in the StdEnv.
-  Bug fixes.

   INSTALLATION
---------------

Installation should be simple:

-  Unzip 'Clean133.zip' to any destination you like.
   Be sure to use an unzipper program that understands long
   file names. Also, extract the files WITH the directory
   structure intact.  
   This will create a 'Clean 1.3.3' folder.

-  In the 'Clean 1.3.3' folder find, and execute the program 'change_registry.exe'
   This will associate the Clean files (.icl, .dcl, .abc and .prj) with the
   CleanIDE and profile files (.pcl, .hcl) with the ShowTimeProfile and
   ShowHeapProfile applications.

-  In the 'Clean 1.3.3' folder find, and execute the program 'CleanIDE'.
   This starts the special Clean development environment.

   COMPILING I/O EXAMPLES
-------------------------

Now you can try to compile one of the example programs.

-  From within the IDE, use the 'Open...' item in the 'File' menu
   to open 'Mines.icl'. You can find Mines in the IOExamples 
   directory. 'Mines.icl' is the top-most implementation module
   of the Mines example.

-  Make a project out of 'Mines' by selecting 'New Project' from the 
   File menu. This creates a new file 'Mines.prj' that you can 
   use later on to open the project and all associated files.

-  By default, Clean applications create a console window (kinda like the 
   MS-DOS window) for their output. Since Mines is a GUI program which
   creates its own windows, you don't want a console for Mines. Disable
   the console creation by first selecting 'Project Options' in the 'Project'
   menu, then select "Application Options" and the "No Console" radio
   button in the dialog that appears.

-  From the 'Project' menu, select 'Run "Mines"'. The IDE will now
   build the application. It will launch 'mines.exe' automatically.

-  Have fun. Be sure to report any bugs you find via email to
   clean@cs.kun.nl

Use the same procedure to compile all other IO example programs. 
You can recognize the top-level implementation module by the fact that
it doesn't have a corresponding '.dcl' file.



   DIFFERENCES BETWEEN THE WINDOWS AND MACINTOSH VERSION OF THE I/O LIB
-----------------------------------------------------------------------

1.  Of the nine pen modes defined in deltaPicture only CopyMode, XorMode
    and HiliteMode are implemented in the Windows 95 version of the I/O
    library.

2.  Pen patterns are not implemented in the Windows 95 version of the I/O
    library.

3.  The function NestIO in deltaEventIO does not exist in the windows 95
    version of the I/O library

4.  The functions SelectInputFile and SelectOutputFile (from 
    deltaFileSelect) have had their types changed. Instead of requiring
    and returning a 'Files' parameter, they now require and return the
    program state. This is also true in the latest version of the
    Macintosh I/O library.

5.  The function OpenNotice now requires and returns an additional
    parameter: the program state. This is also true in the latest version
    of the Macintosh I/O library.



   ONLINE HELP AND DOCUMENTATION
--------------------------------

The Clean System application contains an on-line help facility, which
will give you more information about Concurrent Clean and the Clean
System.

Documentation can be found in the directory

        ftp://ftp.cs.kun.nl/pub/Clean/Clean13/doc

There is a mailing list for discussions about Clean.  Send mail to
"clean-request@cs.kun.nl" with the word "subscribe" in the Subject: field
to join this mailing list.

We also have some pages on the World Wide Web, with documentation, manuals,
papers and versions of Clean for other platforms:

        http://www.cs.kun.nl/~clean/



   PLEASE REPORT BUGS
---------------------


If you find any bugs, have questions, comments or suggestions you can
reach us at:

        clean@cs.kun.nl

